My Simple Raid Frame (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (Interface 11508), Burning Crusade Classic 2.5.6 (Interface 20506)
Version: 1.0.6 (2026. 10. 6.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Raid Frame은 월드 오브 워크래프트 클래식 20주년 서버의 파티/공격대 플레이어를 위한 사용자 정의 공격대 프레임 애드온입니다.

■ 최대 8파티, 40명의 공격대원을 하나의 프레임으로 관리할 수 있으며, 실제 파티/공격대 구성에 맞춰 필요한 구성원만 표시합니다.

■ 공격대에 참여하지 않은 일반 솔로 상태에서는 공격대 프레임을 표시하지 않으며, 위치 이동 모드에서는 40인 전체 미리보기를 표시하여 프레임의 위치를 쉽게 설정할 수 있습니다.

■ 파티/공격대 프레임의 배열 방향, 행/열 수, 클릭 시전, 위협 상태, 버프 및 디버프 상태, 소환수 프레임, 초읽기를 하나의 설정 창에서 관리할 수 있습니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 파티/공격대 구성원 표시
 - 일반 솔로 상태에서는 공격대 프레임을 표시하지 않음
 - 2~5인 파티에서는 실제 파티 구성원을 표시
 - 공격대에서는 실제로 구성원이 존재하는 파티만 표시
 - 오프라인 구성원은 공격대 구성원으로 남아 있는 동안 프레임을 유지
 - 빈 구성원 슬롯은 위치 이동 모드에서만 미리보기 형태로 표시

■ 40인 공격대 프레임 위치 이동 및 미리보기
 - 공격대 프레임 위치 고정 옵션을 설정 창에서 해제하거나 공격대 프레임의 파티 번호 영역에서 Shift+우클릭으로 공격대원 위치 교체 모드를 ON/OFF하면 전체 프레임을 이동할 수 있음
 - 위치 이동 모드에서는 8파티 × 5명, 총 40개의 슬롯을 미리보기로 표시
 - 빈 슬롯은 50% 투명도로 표시하여 실제 구성원과 쉽게 구분
 - 전체 40인 영역 바깥에 8픽셀 두께의 연한 녹색 테두리를 표시
 - 전체 공격대 프레임을 하나의 컨테이너로 이동하고 위치를 저장

■ 전투준비, 풀링 초읽기, 휴식 타이머
 - 파티 번호 영역에서 Shift+좌클릭으로 전투준비를 확인할 수 있음
 - 파티 번호 영역에서 Alt+우클릭/좌클릭으로 풀링 초읽기를 실행/취소할 수 있음, 기본값은 15초로 설정 창에서 시간을 설정할 수 있음
 - 파티 번호 영역에서 Ctrl+우클릭/좌클릭으로 휴식 타이머를 실행/취소할 수 있음, 기본값은 3분으로 설정 창에서 시간을 설정할 수 있음, 시간 표시는 남은 지속시간에 따라 파랑색, 초록색(75% 미만), 노랑색(50% 미만), 주황색(25% 미만), 빨강색(10초 이하) 순으로 바뀜

■ 배열 방향 및 행/열 설정
 - 가로 배열과 세로 배열을 전환할 수 있음
 - 가로 배열은 설정한 행 수를 기준으로 파티 그룹을 아래쪽에 배치
 - 세로 배열은 설정한 열 수를 기준으로 파티 그룹을 오른쪽에 배치
 - 행/열 수는 각각 1~8 범위에서 설정 가능

■ 파티 구성원 소환수 프레임
 - 설정에서 '파티 구성원 소환수 프레임 표시' 기능을 ON/OFF할 수 있음
 - 가로 배열에서는 각 구성원 프레임의 아래쪽에 소환수 프레임을 표시
 - 세로 배열에서는 각 파티 프레임의 아래쪽에 소환수 프레임을 표시

■ 클릭 시전 기능
 - 좌클릭, 우클릭
 - Shift+좌클릭, Shift+우클릭
 - Ctrl+좌클릭, Ctrl+우클릭
 - Alt+좌클릭, Alt+우클릭
 - 각 입력 방식에 사용할 주문 이름을 설정하여 구성원 및 소환수 프레임에서 직접 시전 가능
 - 클릭 시전 주문을 삭제하면 해당 입력 방식은 기본 동작으로 복원

■ 구성원 상태 표시
 - 직업별 색상을 이용한 구성원 이름 및 생명력 표시
 - 생명력 및 자원 상태 표시
 - 사망 및 유령 상태 표시
 - 오프라인 상태 표시
 - 소환 대기 상태 표시
 - 부활 대기 상태 표시
 - 구성원의 부활 시전 대상 프레임에 녹색 테두리 표시
 - 위협수준 대상 발생 시 프레임 바깥쪽에 테두리 표시 (방어전담 설정 대상은 빨간색, 그게 아니면 주황색)
 - 나의 대상 프레임에 청록색 테두리 표시
 - 구성원에게 적용된 디버프의 해제 가능 종류를 우선순위에 따라 색상으로 표시
 - 저주, 마법, 질병, 독 디버프를 각각 구분하여 생명력 바 색상으로 표시
 - 현재 적용된 디버프를 생명력 바 하단에 좌측부터 아이콘으로 표시
 - 자리비움

■ 중앙 상태 아이콘
 - 소환 대기 상태에서는 해당 대상 프레임 중앙에 소환 아이콘 표시
 - 부활 대기 상태에서는 해당 대상 프레임 중앙에 부활 아이콘 표시
 - 드루이드의 환생은 일반 부활과 구분할 수 있도록 환생 고유 아이콘 표시
 - 중재가 적용된 대상은 해당 프레임 중앙에 중재 아이콘 표시
 - 눈속임 대상은 해당 프레임 중앙에 눈속임 아이콘 표시
 - 소멸, 죽은척하기, 투명화, 신의 가호, 천상의 보호막의 시전자와 보호의 축복, 희생의 축복, 자유의 축복, 고통 억제, 공포의 수호물의 대상 프레임 중앙에 해당 아이콘 표시
 - 눈속임, 보호의 축복, 희생의 축복, 자유의 축복, 고통 억제, 공포의 수호물 대상자 프레임의 생명력 바 하단 중앙에 시전자 이름을 표시

■ 버프 및 시전 바 표시
 - 구성원에게 필요한 버프 상태를 생명력 바 하단에 우측부터 아이콘으로 표시
 - 구성원에게 적용된 주요 보호/지원 효과를 생명력 바 중단에 우측부터 아이콘으로 표시
 - 구성원이 현재 시전 중인 주문을 시전 바와 주문 이름으로 표시

■ 설정 거리 기반 반투명 표시
 - LibRangeCheck-3.0을 활용하여 거리를 판정
 - 직업별 스킬이나 아이템 사거리를 기준으로 설정 거리보다 멀다고 판단되는 구성원의 프레임을 흐리게 표시
 - 오프라인 구성원은 거리 판정으로 추가로 흐리게 표시하지 않음

■ 물약 사용 표시
 - 가속의 물약, 파괴의 물약, 무쇠방패의 물약, 최상급 암흑 보호의 물약 사용으로 인한 단기 버프의 아이콘 표시를 선택할 수 있습니다.

■ 프레임 크기 조절 (100%, 50%)
 - 50% 모드에서는 내가 시전한 버프, 부족 버프, 디버프 아이콘이 표시되지 않습니다. 중앙 상테 아이콘은 유지되며 시전자 이름은 생명력 바 하단 영역에서 시전 바로 변경됩니다.

■ GUI 설정 창 지원
 - /msrf 또는 /간단공대 입력 시 설정 창 열기/닫기
 - 애드온 사용
 - 블리자드 기본 공격대 프레임 숨기기
 - 공격대 프레임 위치 고정
 - 설정거리 초과 구성원 반투명 표시
 - 위협수준 대상 테두리 표시
 - 파티 구성원 소환수 프레임 표시
 - 시전한 내 버프 아이콘 표시
 - 토템 버프 아이콘 표시
 - 부족한 내 버프 아이콘 표시
 - 생명력 절대 수치 표시
 - 배열 방향 및 행/열 수
 - 클릭 시전 주문
 - 풀링 초읽기 및 휴식 타이머
 - 프레임 색상 및 폰트
 - 물약 사용 표시
 - 프레임 크기 조절

─────────────────────────────
3. 설치 방법
─────────────────────────────
■ 이 애드온은 라이브러리를 내장하여 작동하므로 별도의 설치가 필요 없습니다.

■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── MySimpleRaidFrame
          ├── MySimpleRaidFrame.lua
          ├── MySimpleRaidFrame_Vanilla.toc
          ├── MySimpleRaidFrame_TBC.toc
          ├── README.txt
          └── Libs
               └── LibRangeCheck-3.0 (내부 하위 폴더 포함)

■ 게임 내 '애드온' 탭에서 [My Simple Raid Frame]이 활성화되어 있는지 확인합니다.

─────────────────────────────
4. 사용 예시 및 명령어
─────────────────────────────
■ 기본 명령어
 - /msrf 또는 /간단공대: 설정 창 열기/닫기

■ 기본 사용 방법
 - 애드온을 활성화한 뒤 설정 창에서 원하는 기능을 설정합니다.
 - '공격대 프레임 위치 고정'을 해제하거나 파티 번호 영역에서 Shift+우클릭하면 공격대 프레임을 이동할 수 있습니다.
 - 파티 번호 영역에서 Shift+좌클릭하면 전투준비를 확인할 수 있습니다.
 - 파티 번호 영역에서 Alt+우클릭/좌클릭하면 풀링 초읽기를 실행/취소할 수 있습니다. 설정 창에서 시간을 설정할 수 있습니다.
 - 파티 번호 영역에서 Ctrl+우클릭/좌클릭하면 휴식 타이머를 실행/취소할 수 있습니다. 설정 창에서 시간을 설정할 수 있습니다.
 - 위치 이동 모드에서는 40인 전체 미리보기를 이용하여 원하는 위치에 배치할 수 있습니다.
 - '파티 구성원 소환수 프레임 표시'를 활성화하면 각 구성원의 소환수 프레임이 배열 방향에 따라 아래쪽 또는 오른쪽에 표시됩니다.
 - 클릭 시전 주문을 설정하면 지정한 마우스 입력으로 해당 주문을 구성원 또는 소환수에게 시전할 수 있습니다.
 - 클릭 시전 주문을 삭제하면 해당 입력 방식은 기본 좌클릭 대상 선택 또는 우클릭 유닛 메뉴 동작으로 돌아갑니다.
 - 설정 거리 초과 구성원 반투명 기능을 활성화하면 설정한 사거리보다 확실히 먼 구성원이 반투명하게 표시됩니다.
 - 눈속임을 사용하면 눈속임 대상의 프레임 중앙에 눈속임 아이콘이 표시되고 시전 바 위치에 시전자 이름이 표시됩니다.
 - 부활이나 환생을 수락할 대상의 프레임에는 해당 부활 상태를 나타내는 중앙 아이콘이 표시됩니다.
 - 소환 요청을 수락할 대상의 프레임에는 소환 상태를 나타내는 중앙 아이콘이 표시됩니다.
 - 중재 대상의 프레임에는 중재 상태를 나타내는 중앙 아이콘이 표시됩니다.
 - 위협수준 대상, 부활 시전 대상, 대상의 프레임에 별도의 테두리가 표시됩니다.
 - 특정 물약 사용으로 인한 단기 버프를 표시할 수 있습니다.
 - 프레임 크기를 100%, 50% 중에서 선택할 수 있습니다.

─────────────────────────────
5. 주의 사항
─────────────────────────────
■ 공격대 프레임의 보호 기능 때문에 전투 중에는 위치를 이동할 수 없습니다.

■ 거리 측정 기능은 LibRangeCheck-3.0에서 제공하는 스킬 및 아이템 사거리 정보를 바탕으로 작동합니다. 따라서 정확한 실측 미터(m) 값이 아닌, 사용 가능한 스킬 및 아이템 사거리를 기준으로 거리 초과 여부를 판단하여 반투명 처리가 적용됩니다.

■ 클릭 시전 기능은 설정한 주문 이름과 현재 캐릭터가 실제로 사용할 수 있는 주문에 따라 동작합니다.

■ 클릭 시전 설정을 삭제하면 해당 마우스 입력은 기본 좌클릭 대상 선택 또는 우클릭 WoW 기본 유닛 메뉴 동작으로 복원됩니다.

■ 소환수 프레임은 설정에서 활성화한 경우에만 표시되며, 파티 구성원의 소환수가 없는 경우 해당 소환수 프레임은 표시되지 않습니다.

■ 중앙 상태 아이콘이 2개 이상 표시될 경우에 가운데 정렬로 왼쪽부터 순서대로 표시됩니다. 시전자 이름은 먼저 건 사람이 우선적으로 표시되고, 종료된 이후에도 다른 버프가 남아 있다면 해당 시전자의 이름이 표시됩니다.

■ 프레임 크기 100% 모드에서 (자리비움)은 (오프라인), (사망)과 별도로 표시됩니다. 50% 모드에서는 (오프라인), (사망), (자리비움) 순으로 표시됩니다.

■ 블리자드 기본 공격대 프레임 숨기기 기능을 사용할 경우 기본 공격대 프레임 대신 My Simple Raid Frame을 사용하게 됩니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 9. 15.)
 - 최대 8파티, 40인 사용자 정의 공격대 프레임
 - 솔로/파티/공격대 상태에 따른 구성원 자동 표시
 - 공격대 프레임 위치 이동 및 40인 전체 미리보기
 - 가로/세로 배열 방향 및 행/열 수 설정
 - 버프/디버프 상태 및 해제 가능 디버프, 소환/부활 상태, 부활/위협수준/타겟팅 대상 테두리, 시전 바, 전담 역할 및 공격대 징표 표시
 - 중앙 상태 아이콘을 통한 소환, 부활, 환생, 중재, 눈속임 상태 표시
 - 파티 구성원 소환수 프레임 표시
 - LibRangeCheck-3.0 기반 거리 기준으로 반투명 표시
 - 캐릭터별 설정 저장

■ 1.0.1 (2026. 9. 27.)
 - 본인 파티 이외의 공격대원에게 클릭 시전이 되지 않던 오류를 수정

■ 1.0.2 (2026. 9. 29.)
 - 세로 배열에서 소환수 프레임 사이의 간격을 절반으로 수정
 - 전투준비 표시 추가

■ 1.0.3 (2026. 10. 2.)
 - 환생 대상 프레임의 중앙 상태 아이콘이 일반 부활과 동일하게 나오던 오류를 수정
 - 사망 시에 유령 아이콘이 중복돼서 나오던 오류를 수정
 - 공격대 프레임 위치 고정 여부를 파티 번호 영역에서 시프트+우클릭으로 변경했을 때 설정 창의 항목 체크와 동기화되지 않던 오류를 수정
 - 파티 번호 영역 단축키에 전투준비, 풀링 초읽기, 휴식 타이머를 추가
 - 주문 이름이 길어서 시전 바의 폭을 넘어설 경우에 뒷부분을 생략하도록 수정
 - 프레임 색상 및 폰트 설정을 추가
 - 생명력 바의 그러데이션 효과를 제거하기 위해 텍스처를 수정
 - 설정 창 항목들의 문구 및 구조를 수정

■ 1.0.4 (2026. 10. 5.)
 - 소환 대상 프레임의 중앙 상태 아이콘이 제한 시간 2분이 지나면 수락 여부에 상관없이 사라지도록 수정
 - 오프라인 상태가 되면 모든 중앙 상태 아이콘이 사라지도록 수정
 - 폰트 글자 모드에서 사망자 이름과 생명력 수치, 사냥꾼의 사망한 소환수 이름을 흰색으로 표시하도록 수정
 - 자원 바 수정 (높이 2배 확대, 생명력 바와의 사이에 검정색 경계선 추가)
 - 물약 사용으로 인한 단기 버프 표시 추가 (가속, 파괴, 무쇠방패, 암흑 보호)
 - 부활 시전 대상 프레임에 생겨야 할 녹색 테두리가 간혹 시전자 프레임에 생기던 오류를 수정
 - 중앙 상태 아이콘 추가 (신규: 소멸/죽은척하기/투명화/신의 가호/천상의 보호막, 변경: 보호의 축복/희생의 축복/자유의 축복/고통 억제/공포의 수호물)
 - 생명력 바 중단에 아이콘을 표시하는 단기 버프 수정 (보호의 축복/희생의 축복/자유의 축복/고통 억제/공포의 수호물 제외)
 - 생명력 절대 수치 표시 모드일 때 사망자의 생명력 수치를 (사망)으로 수정
 - 프레임 크기 조절 기능 추가 (100%, 50%)

■ 1.0.5 (2026. 10. 5.)
 - 잘못된 함수 호출로 인한 Lua 오류 수정
 - 자리비움 상태인 구성원 프레임의 시전 바 위치에 (자리비움) 표시 추가

■ 1.0.6 (2026. 10. 6.)
 - 배열 방향이 가로(행)일 때 파티 번호 영역의 단축키 기능이 작동하지 않던 오류를 수정
 - 기본 흰색 테두리 삭제

─────────────────────────────
7. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

■ 본 애드온에서 사용하는 제3자 라이브러리의 저작권 및 이용 조건은 해당 라이브러리의 원 저작자 및 라이선스 조건을 따름

─────────────────────────────
8. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
